ATSUUnderwriteAttributes

OSStatus ATSUUnderwriteAttributes (
ATSUStyle iSourceStyle,
ATSUStyle iDestinationStyle);

iSourceStyle

A reference of type ATSUStyle. Pass a reference to a valid style object whose previously set values you want to copy. You cannot pass NULL for this parameter.

iDestinationStyle

A reference of type ATSUStyle. Pass a reference to a valid style object whose corresponding unset values you want to replace. You cannot pass NULL for this parameter.

function result

A result code. See Result Codes.

DISCUSSION

The ATSUUnderwriteAttributes function copies those style run attributes, font features, and font variations that were previously set in the source style object but not set in the destination style object. All other quantities in the destination style object are left unchanged.

ATSUUnderwriteAttributes does not copy the contents of memory referenced by pointers or handles within custom style run attributes or within reference constants. You are responsible for ensuring that this memory remains valid until the source style object is disposed of.

To create a copy of the entire contents of a style object, call the function ATSUCreateAndCopyStyle. If you wish to copy the entire contents of a style object into an existing style object, you should call the function ATSUCopyAttributes. To copy style run attributes, font features, and font variations that were previously set in the source style object into the destination style object, regardless of whether or not these values are set in the destination style object, call the function ATSUOverwriteAttributes.

SPECIAL CONSIDERATIONS

ATSUUnderwriteAttributes may allocate memory in your application heap, unless you designate a different heap by calling the function ATSUCreateMemorySetting.

VERSION NOTES

Available beginning with ATSUI 1.0.